home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / answer2.arc / ANSWER.DOC < prev    next >
Encoding:
Text File  |  1985-08-14  |  10.5 KB  |  197 lines
  1.  
  2.                        ░░░▒▓  the ELECTRONIC   ▓▒░░░
  3.                        ░░░▒▓ ANSWERING MACHINE ▓▒░░░
  4.  
  5.  
  6.          The 'ELECTRONIC ANSWERING MACHINE' is, simply, a computerized
  7.     version of the plain old voice answering machine.  When you go out
  8.     to get lunch, go to a movie, or whatever, just pop up EAM and  you
  9.     will never miss another important message again.  It's very simple
  10.     to use and  maintain,  the few instructions necessary are outlined
  11.     below.  The original idea  for this program inspired by Sean Nolan
  12.     who wrote the original version of EAM called simply AM  (Answering
  13.     Machine). 
  14.  
  15.     Early in August, 1985, I was faced with a failure on the HARD DISK
  16.     I was using to support my BBS system.  As a consiencious BBS sysop
  17.     I searched for the right tool to stay in touch with my users while
  18.     the HARD DRIVE was being repaired/replaced.   I found the original
  19.     AM program by Sean Nolan and attempted to run it on my system. The
  20.     original program would not even pick up the phone upon receiving
  21.     an incomming call.  There were other problems that followed:
  22.  
  23.     1. The caller's communications parameters had to match the 
  24.        method used to open the COM1 or COM2 line EXACTLY.  The program
  25.        was very unforgiving about this.  EAM automatically switches
  26.        to re-configure itself to the callers settings.
  27.  
  28.     2. There was no mechanism to hang up in the event that the caller
  29.        terminated simply by dropping carrier.  At best, you had to 
  30.        endure a time-out by decrementing a counter.  This was maintain-
  31.        ed as a REAL number of 340000! (or something like that)
  32.        This has obvious disadvantages for multi-tasking or using a 
  33.        compiled version of the program.  EAM will reset immediately
  34.        upon detecting loss-of-carrier. EAM also sets waits by using
  35.        appropriate number of SECONDS by reading the system timer.
  36.  
  37.     3. Much of the messages and prompts were "hard-coded" and not easily
  38.        changed by the inexperienced user.  This version places the most
  39.        commonly changed items on the first line of code, and both the
  40.        initial message and trailing (logoff) message are read from disk.
  41.  
  42.     4. A facility has been included to allow the remote SYSOP to list
  43.        his messages from the remote point. (Kinda like having one of those
  44.        fancy little beepers that let you read your phone messages from
  45.        any outside telephone).
  46.  
  47.     5. CHAT mode has been greatly improved over the original code, as well
  48.        as the text editor used to enter messages to the system operator.
  49.        the format of the MESSAGES file contains the callers name and time
  50.        that he called.  The call number is also recorded.
  51.  
  52.     6. LOCAL mode is also supported in all but the CHAT function.  After all
  53.        who would talk to himself, anyway?  Not me! (Are you sure?) fersure!
  54.  
  55.     7. Since the program is essentially a long-running BASIC program, it is
  56.        susceptable to running out of string-space by variable re-definition
  57.        unless you take special care to issue a CLEAR statement.  EAM does
  58.        a FULL reset each time a caller hangs up.  It maintains the current
  59.        BEEP and CHAT setting on a disk file across the RE-INITIALIZATION so
  60.        that these settings are not lost.
  61.  
  62.     8. Error-handling for communications problems and missing disk-files 
  63.        did not exist in the original program beyond displaying the line#
  64.        of the failing statement.  EAM has extensive error-handling and can
  65.        tolerate all but the most uncommon problems.
  66.  
  67.     Most of the resulting code is taken directly from techniques used either
  68.     by Sean Nolan in the original program, or from techniques used in RBBS
  69.     itself.  So in reality... I must acknowledge all of the developers of 
  70.     RBBS as contributing, in some way, to this program.  If you desire... 
  71.     EAM can be the beginning of your own custom BBS software... all of the
  72.     communications routines would work just fine in such an effort.
  73.     It has even found use as an Electronic MAIL-DROP for PC users wishing to
  74.     avoid the high cost of commercial electronic-mail systems.  Consider 
  75.     other possibilities !
  76.  
  77.     -----------------------------------------------------------------------
  78.       The documentation that follows, shows just how easy the ELECTRONIC
  79.       ANSWERING MACHINE is ... to operate and maintain.
  80.     -----------------------------------------------------------------------
  81.  
  82.     OPENING MESSAGE - When a remote user first logs on to EAM,  he is given
  83.     a welcome message not unlike that displayed by RBBS:
  84.  
  85.     WELCOME TO ZAP!-BBS              (...or whatever)
  86.  
  87.     He is then sent a message asking if he needs linefeeds, and his REAL 1st
  88.     and Last name.  After this is completed, the disk-file named "OUTMSG" is
  89.     sent.  This file is optional but I can't see why you would ever NOT have
  90.     one.  The intent is to describe to the caller what  he has  dialed into,
  91.     and  (maybe)  why the normal system is down (or some other stuff).
  92.  
  93.     After the file OUTMSG is displayed... the following menu appears:
  94.  
  95.     Main Menu:
  96.     E)nter msg  O)perator page  G)oodbye  H)elp : _
  97.  
  98.  
  99.     These functions are outlined below:
  100.  
  101.     ENTER A MESSAGE - The system also allows for the remote user  to 
  102.       enter  a message for the operator.   The message editor is simple 
  103.       and  self-explanitory,  just view the file menu help file to  see 
  104.       the functions.   These messages are saved under the name MESSAGES 
  105.       and may be read by using TYPE MESSAGES from DOS or by VIEWING the
  106.       file either under LOCAL mode or by calling in remotely and  using
  107.       the hidden command ~  (Tilde).  This will allow the remote system
  108.       operator to view his messages from some outside terminal. To clear
  109.       the messages  file,  type ERASE MESSAGES from under DOS.
  110.  
  111.     CHAT  - One  option the remote user may choose is O)perator page to 
  112.       Chat with the operator.  If the SYSOP is available, EAM will then
  113.       page the operator through the use of a pulsating beep  (for up to
  114.       30 seconds).  During this time, the operator should press the F3
  115.       key to enter CHAT conversational mode.  Just type away...and your
  116.       characters  will come out on the remote screen,  as well as  your 
  117.       own.  To end chat mode and return to the command prompt, type the 
  118.       <ESC> escape-key.  EAM, at initial start-up, checks the  settings
  119.       for CHAT and BEEP in the configuration file.  If the CHAT setting
  120.       is OFF,  the caller will be informed  that  you are not currently
  121.       available... and would he optionally please leave a message.
  122.  
  123.       Finally, at any time during program usage, the operator can press
  124.       the F3 key and the system will break into chat mode.
  125.  
  126.     GOODBYE - when the caller decides that he has had enough...  he can
  127.       terminate his session bye responding with the G)oodbye command.
  128.       The file BYEMSG is then displayed to the caller (if it exists) and
  129.       then the communication line is closed, effectively hanging up on
  130.       the caller.  It is suggested that you customize the BYEMSG file
  131.       with your text editor for a cordial fare-well.
  132.  
  133.     HELP - more detailed description of the available commands is available
  134.       for both the main menu and the ENTER MSG menu (text editor menu).
  135.  
  136.  
  137.     The function keys are active at any time during the caller's session.
  138.     They are assigned the following functions:
  139.  
  140.     F1 - toggle whether the operator is available to CHAT
  141.     F2 - toggle whether to silence or activate the BEEP
  142.     F3 - activate CHAT (can be used at any time irregardless of F1 setting)
  143.     F4 - IMMEDIATE FLUSH.  purge the caller and reset EAM for next call.
  144.  
  145.  
  146.      It is suggested that you execute a program such as CRTSAVE to auto-
  147.      matically turn off the crt screen in the event that there is no 
  148.      terminal activity.  This will prevent the BURN-IN that could occur
  149.      if the same screen image is displayed for a length of time.
  150.      A batch file might consist of the following statents:
  151.  
  152.      ECHO OFF
  153.      CLS
  154.      CRTSAVE
  155.      BASICA ANSWER          ... or simply "ANSWER" 
  156.                                 if you are using the compiled version
  157.  
  158.    ----------------------------------------------------------------------
  159.  
  160.      Enjoy this most useful little software offering!   This program is
  161.      copyrighted, but it may be distributed in any media, provided that:
  162.  
  163.      1. You do not alter or remove the REM statements out of the 
  164.         source code or alter the documentation in any way.
  165.         That you include BOTH answer2.bas + answer2.doc in whatever
  166.         media is chosen for distribution.
  167.  
  168.      2. You do not DISTRIBUTE a modified version of this code.  If you MUST
  169.         modify the software,... use the accepted practice of creating a
  170.         MERGE file to contain your changes.  In this way... any bugs which
  171.         are fixed or new feature which are to be included can be done in a
  172.         reasonably maintainable fashion.
  173.         
  174.      3. Charge no fees for the distribution of this software beyond the
  175.         minimal charge ($4 maximum) for a distribution diskette.
  176.         If other programs are included on the diskette, do not charge
  177.         more than once for the distribution diskette.
  178.  
  179.  
  180.      If you would like to receive free updates of the program, 
  181.      send a donation ($20 is suggested for private use, $20 minimum for
  182.      commercial or corporate usage is mandatory) to:
  183.                     
  184.                          Mike Sirmans
  185.                          4022 Tanglewood Rd.
  186.                          Snellville, GA  30278
  187.  
  188.                          Call:  ZAP!-BBS  (404) 972-3458
  189.                          Supporting ASCII & XMODEM downloads
  190.                          at 2400/1200/300 baud 24-hrs/day
  191.  
  192.  
  193.      Please also send me any changes you would like to make in the program,
  194.      I'd really like  to see what you people  do with it.   Please send any
  195.      submissions for updates in TEXT to the Data Number listed above. 
  196.  
  197.